Allabu Solapi Kakao

Send Kakao Message

Overview

This node sends Kakao messages using the Solapi messaging API. It is designed to send templated KakaoTalk messages to specified recipients, which is useful for businesses or services that want to automate customer notifications, alerts, or marketing messages via KakaoTalk.

Typical use cases include:

  • Sending appointment reminders or confirmations.
  • Delivering promotional messages with dynamic content.
  • Notifying users about transaction statuses or updates.

The node constructs a secure API request with HMAC-SHA256 authentication and sends message details including recipient phone number, template ID, and variables for template customization.

Properties

Name Meaning
My String A customizable string input; described as "The description text". Default value is "allabu".

Note: The provided code does not utilize this property in the execution logic, so it appears to be a placeholder or example input.

Output

The node outputs JSON data containing information about the message sending result. The structure of the json output field is:

{
  "data": "{\"messageId\":\"1234567890\",\"status\":\"success\",\"recipient\":\"01094843852\",\"message\":\"Test message sent successfully\"}"
}
  • messageId: Identifier of the sent message (mocked as "1234567890").
  • status: Status of the message sending operation (e.g., "success").
  • recipient: Phone number of the message recipient.
  • message: Confirmation message indicating success.

The output is always returned as a JSON string inside the data field. No binary data output is produced by this node.

Dependencies

  • External Service: Solapi Kakao Messaging API endpoint at https://api.solapi.com/messages/v4/send-many/detail.
  • Authentication: Requires an API key and secret to generate HMAC-SHA256 signature for authorization headers.
  • Node.js Modules: Uses axios for HTTP requests and crypto for generating random salts and HMAC signatures.

n8n Configuration:

  • The node expects an API key and secret to be configured (hardcoded in the source here but should be replaced with credentials).
  • No environment variables are explicitly referenced, but secure storage of API credentials is necessary.

Troubleshooting

  • Common Issues:

    • Invalid or missing API key/secret will cause authentication failures.
    • Incorrect template IDs or profile IDs may result in message sending errors.
    • Network issues or API downtime can cause request failures.

  • Error Messages:

    • Axios errors will log detailed response status, data, and headers if available.
    • If no response is received, a specific error message indicates server unavailability.
    • Unexpected errors are logged generically.

  • Resolution Tips:

    • Verify API credentials and ensure they are correctly set.
    • Confirm that the Kakao template and profile IDs are valid and active.
    • Check network connectivity and API service status.
    • Review error logs for detailed response information to diagnose issues.

Links and References

Discussion